COMMENT ⊗   VALID 00007 PAGES
C REC  PAGE   DESCRIPTION
C00001 00001
C00002 00002	Introduction
C00003 00003	Use of DM Hardware
C00006 00004	Use of DM Software
C00021 00005	Use of DMs via TIPs
C00027 00006	Use of DMs from TENEX/TOPS20 Hosts
C00029 00007	Use of DMs from ITS Hosts
C00031 ENDMK
C⊗;
Introduction


This file, DM.ME[UP,DOC], lists some facts and procedures of interest to
SU-AI users of the Datamedia Elite 2500A display terminal equipped with
SUMEX keyboard (hereafter abbreviated "DM"), and other terminals (e.g.,
Datamedia 3025s, IMLACs) which emulate DMs.
Use of DM Hardware


When using the DM with a 300 baud modem:

(1) Connect pins 2, 3, and 7 of the DM LINE connector to pins 2, 3, and 7,
respectively, of the modem's TERMINAL connector.

(2) Switch the terminal's speed selector to 300 and dial in.

(3) To disconnect, hang up the phone.


When using the DM with an internal 150/1200 baud modem:

(1) Connect stub cable coming out of back of terminal into the terminal's
LINE connector.

(2) Plug white cable into jack at back of terminal.

(3) If your phone doesn't have a jack, remove the cover of the little box
where the wire goes into the wall and replace with the adapter provided,
creating a phone jack.

(4) Plug other end of white cable into your phone jack.

(5) If the phone has a plug, plug it into the back of the plug you just
inserted.

(6) Switch the terminal's speed selector to SEL.

(7) Push the small switch next to the speed selector to the left.

(8) Now dial SU-AI or SU-TIP (or whatever).  When the modem answers with a
tone, switch the small switch to the right and hang up the phone.

(9) To disconnect, push the BREAK key on the terminal for a few seconds
until the CD light (the top one in the column of lights below the screen)
goes out, and then push the small switch to the left and the line will be
released.  PLEASE don't forget to hit BREAK before disconnecting; if you
forget, the modem you were talking to at the computer end may think you
are still there (forever).
Use of DM Software


[Note:  If you have trouble with typeout at any time, especially if tabs
in the typeout don't seem to work, type [BREAK] P (see below for how to
type this), which will clear and refresh your screen, including setting
your DM's tab stops.  If your DM doesn't have tab stops, type the monitor
command TTY NO TABS and then type [BREAK] P.  If you have trouble with
your line editor, type [ESC] R.]

DM terminals are considered full display terminals by the system, and as
such they have virtually all the capabilities possessed by DD and III
displays except (1) keyboard and screen mapping, (2) audio switch control,
and (3) vector displaying.  In particular, the line editor, the wholine,
and the full Stanford AI Lab character set with CONTROL and META bits are
available on DMs, although a few Stanford characters must be quoted (see
below) in order to be input.

To have a list of DM keyboard commands printed on the XGP, type HELP DMKEY
to the monitor and follow instructions; this can only be done on a DD or
III display since it causes XGP output which should be picked up
immediately.

Since the DM keyboard does not have keys for all of the Stanford
characters, certain characters must be typed in their ASCII CTRL form; for
example, partial-sign (∂) is ↑O and thus must be input as CTRL-O.  Also,
since the DM display does not have symbols for all the Stanford
characters, those characters that must be typed in as CTRL-something will
be displayed in a special form, namely as either BOLD-something or as
BLINKING-something.  On SU-AI DMs, CTRL-something will appear as
BOLD-something; on other DMs that have not been modified to interchange
the BLINKING and BOLD functions, CTRL-something will appear as
BLINKING-something.  For example, on SU-AI DMs partial-sign (∂ or ↑O) will
be displayed as BOLD-o; on non-modified DMs it will be BLINKING-o.  If you
have a non-modified DM and don't like blinking (you won't), then type TTY
NO BOLD or use the NOBOLD LOGIN option.  The XGP printout made by HELP
DMKEY lists the correspondences between Stanford AI Lab characters and
their ASCII CTRL representation.

Here is a summary of what you have to type to get certain effects:

    To get [ESC], type [NUL].  Most DD-type [ESC] commands work on DMs.
    To get [BREAK], type [NUL] and then "-" (minus sign).
    To get (CONTROL)<char>, type (EDIT)<char>; that is, hold down
		(EDIT) while typing <char>.
    To get (META)<char>, type (EDIT)[NUL] and then <char>.
    To get (META)(CONTROL)<char>, type (EDIT)[NUL] and then (EDIT)<char>.

    To undo [ESC] or [BREAK], type [DEL].
    To undo (META), type [NUL] and then [DEL].

    To get [CLEAR], type the bottom unlabelled key at keyboard left, or [MR].
    To get [FORM], type [↑L].
    To get [BS], type [DEL].
    To get [CALL] (that is, two ↑C's), type [CALL].
    To get deferred [CALL] (that is, one ↑C), type (EDIT)[CALL].

    To suspend typeout, type [HOLD]; to resume typeout, type [HOLD] again.

    To flush all the output queues, type (EDIT)[CLEAR] (where [CLEAR] is
    the bottom unlabelled key at left, as above).  This flushes the
    wholine, user-program, piece-of-paper, line-editor and special queues
    for the DM and generates an INTFOP interrupt for any network server
    controlling the DM so that it can flush any output text in the network.

The three characters β≡∨ are hidden under the keys [CALL], [CLEAR], and
[HOLD], respectively.  To get one of the characters β≡∨, you must quote it
by preceding it with [NUL].  However, if you want (META) with the
character, then the quoting is automatic with the add-(META) command
(EDIT)[NUL].  Thus you cannot type (META)[CALL], (META)[CLEAR], or
(META)[HOLD] because you would get (META)β, (META)≡, or (META)∨ instead.

You must tell the system you are a DM by either typing the TTY DM command
or logging in with DM among your LOGIN options (if you have a DM with the
full Stanford character set, use the TTY DM128 command and DM128 option
instead).  The system will erase the DM screen and then set the DM's tab
stops while typing an initialization message at the top of the screen.  If
you have a DM terminal that lacks hardware tabs (all of the AI Lab's DMs
have them), then you should type TTY NO TABS (or have the NOTABS option);
in that mode each tab to be output will be converted to an equivalent
number of spaces, which will of course usually take longer to output than
just a tab.

When you log out of a directly dialed line, your terminal will "go
available" about five seconds later.  A beep is output to tell you when
this has happened--your screen will not be erased at that time.  You
should not hang up the phone until you hear this beep; otherwise, someone
else may call in right then and be able to see what was displayed on your
screen.  When your terminal is "available", you cannot type [ESC] or
(META) until you have typed some other character to initialize the
terminal.  Typing [ESC] or (META) to an uninitialized terminal will cause
the echoing of a beep with no other result.

If you do not get the initialization message when you first type a
character after dialing in, then you should immediately do a [BREAK] P
(i.e., the three characters [NUL] - P) to force it.  This will usually
show you the display screen of the previous user who probably hung up
before the terminal "went available".  If you don't type [BREAK] P in this
case, there is no guarantee of consistent output as your terminal may have
its cursor at some place other than where the system thinks it is.  If
[BREAK] P doesn't get you the initialization message but does erase and
redraw the screen, then type the monitor command TTY TABS (unless your DM
terminal doesn't have hardware tabs), followed by another [BREAK] P, which
should get you the message at the top of the screen.  If typeout screws up
after correct initialization, then either you are having phone line
trouble or there is a bug in the DM display service--the former is the
best guess.  If you get perfectly repeatable typeout screwups, then you
may have found a display service bug and you should report to ME exactly
what you did to cause it.  You should also verify that it happens on more
than one phone line.  If it only happens on one phone line, then you
should report the phone line trouble to TED.


Notes:

The user job part of the wholine is only updated when it has changed.

The don't-allow-beeps command [BREAK] B is not valid from DMs as they have
no audio switch selection to preserve.  You can however turn your beeper's
volume up or down on the back of the keyboard.  Put your terminal into
local mode by disabling FULL DUPLEX and type CTRL-G to make it beep to
adjust the volume.  Be sure to restore FULL DUPLEX when done.

Dpy programs (UPGIOT UUO) now run on DMs--see UUO.UPD[S,DOC], page 15.

While you are holding (even if HOLDING message does not appear), your line
editor will appear on the HOLDING message line (3rd line of screen).

Two new escape commands are now available to DM users for suppressing user
program display output outside of a specified range of columns on the
display.  [ESC] m < (where m is decimal) suppresses all user display
output to the left of column m, and [ESC] n > (n decimal) suppresses all
user display output to the right of column m.  The only type of output
these commands affect is user program output generated by the UPGIOT UUO
(i.e., display program output), and even then it does not affect output in
insert/delete mode nor does it affect output of CRs and LFs.

Note that [ESC] 5 < (for example) will suppress output to the left of
column 5 and therefore whatever text already appears in columns 1 to 4
will (normally) not be erased even when new text appears starting in
column 5.  However, after an [ESC] 40 > (for example) old text in columns
41 to 80 will usually be erased by new text at or before column 40 since
output of actual text usually causes the rest of the line to be erased
(except when this erase-to-end-of-line feature is inhibited).  Also, if,
for example, [ESC] 20 < and [ESC] 10 > are given, all output is suppressed
except for CRs and LFs and the line erases.

Thus these commands can be used to speed up displaying by E, WHO and other
display programs by suppressing unneeded output.

[ESC] < resets the left DM margin to zero and [ESC] > resets the right DM
margin to infinity.  [ESC] N resets both margins, as does a RESET or
DPYCLR UUO.  [BREAK] > sets the right margin to 0, thus suppressing all
text.

Two new login options are available for your OPTION.TXT file.  These are
useful if you login remotely sometimes on a Datamedia (DM) and sometimes
not.  The new options are FDM and FDM128 (Fast DM options).  With either
of these, LOGIN will tell the system that your terminal is a DM if and
only if you are on one of the high-speed dialup lines (TTYs 0 through 5).
The FDM128 option will also tell the system that your DM can display all
128 Stanford characters (provided you are on a high-speed dialup line).
Like the options DM and DM128, these options take an optional following
argument to specify the number of lines your (simulated) DM has on its
screen, with the form being FDM=30 or FDM128=30 (for 30 lines).
Use of DMs via TIPs


DM display service is now available via TIPs.  It's most useful from
150/1200 baud ports (available on both SU-TIP and AMES-TIP) or faster, but
should work from 110-300 baud ports (and other TIPs as well).

When you tell the SU-AI system that you are on a DM (step 4 below), the
system will tell the TIP to do a @B[inary] I[nput] S[tart] command so that
the EDIT-key bit and NULLs will be transmitted whenever you type them.
While you are in Binary Input mode, you won't be able to give any commands
to the TIP, since EVERYTHING you type will be passed straight through to
SU-AI.  To get out of Binary Input mode, see step (7c) below.


Here are the steps to follow (text to be typed in that is shown in
brackets is optional):

(1) Dial up a TIP port.  SU-TIP telephone numbers are found in
TIP.BPM[UP,DOC].  Ask BPM for the telephone numbers of the AMES-TIP or
TIPs outside the Bay Area.

(2) If you have dialed a nonhunting port (e.g., 150/1200 baud), reset the
port to its standard configuration by typing

	@R[eset]<cr>

If you have dialed a hunting port (e.g., 110-300 baud), type in the
appropriate hunt character (e.g., "E").  In either case the TIP should
type back its name, TIP software version number, and port number, e.g.,

	SU TIP 420 #: 10

(If the TIP echoes "@R", but doesn't print its herald string, then you
probably need to type

	@I[nsert] L[inefeed]<lf>

to allow TIP commands to be terminated with just a carriage return.)

(3)  Open a connection to SU-AI with

	@O[pen] 11<cr>

(4)  Finally tell SU-AI that you are a DM with

	.TTY DM<cr>

If all of your remote logins are from DMs, you can avoid having to do this
step by including the "DM" LOGIN option in your OPTION.TXT file.

(5) Login and use the system as you normally would with a directly dialed
DM.

(6) Logout as usual.

(7a) Hit BREAK for a few seconds to break the connection.  Then hang up
the telephone.  This resets the TIP port, including the flushing of
Eight-Bit Binary Mode.

	OR

(7b) Wait one minute without doing anything (having already logged out).
The TELNET server will put the DM back into scroll mode, then will close
the connection.  This allows you to use the TIP to talk to another ARPAnet
site (closing the connection automatically turns off binary mode).

	OR

(7c) Type

	.TTY NO DM<cr>

This will make SU-AI no longer treat you as if you are on a DM, and as a
result the TIP will be instructed to disable Binary Input mode.  After
this you can once again give commands to the TIP, for instance to close
the connection and maybe connect to another ARPAnet host.  Step (7c)
can be used at any time while you are talking to SU-AI, even if you are
still logged in.  This is useful if, for instance, you want to give
some TIP command (which you cannot do while in Binary Input mode).


In summary, here is the normal sequence of commands you should type
between dialing up the TIP and logging in to SU-AI:

	@R	(or just "E" on a hunting port)
	@O 11
	.TTY DM

The entire TIP command language is documented in the "User's Guide to the
Terminal IMP" by BBN, which is found in TIPUG.BBN[UP,DOC].
Use of DMs from TENEX/TOPS20 Hosts


GFF has hacked up a version of NTELNET (a version of TELNET which uses the
New Telnet protocol, now called TELNET at SRI and ISI sites, also
available at SUMEX-AIM) that allows one to use AI Lab Datamedia display
service over the ARPAnet from TENEX or TOPS20 sites.  All one must do is
enter Transparent Mode within NTELNET (analogous to Eight-Bit Binary Mode
on TIPs).

If your DM is actually running at a baud rate higher than 1200, you 
will probably need to tell the SU-AI system the baud rate so that
the proper amount of padding can be inserted (for DM 2500s).  The
command to do this is
	.TTY DMBAUD nnnn
where nnnn can be any decimal value up to 25500 or so.
Use of DMs from ITS Hosts


The best way to be a display at SAIL from an ITS host is to use one of
their TV's and use the SUPDUP program to telnet to here.  This uses the
SUPDUP protocol, and allows you to use their TV keyboards like a funny
kind of Stanford keyboard (ie, CONTROL, META, CALL, etc. work).  The way
to SUPDUP to SAIL is by typing SAIL<CONTROL>K.

Internally, the SUPDUP server here at SAIL makes the network terminal a
Datamedia with the full character set, and does all the mappings between
the SUPDUP and Datamedia protocols; so if you are visiting MIT you can use
it without knowing anything about Datamedias.

To use a physical Datamedia from an ITS host, tell ITS you are a Datamedia
with the :TCTYP DATAMEDIA<CR> command.  Then, TELNET to SAIL and give the
"D" command to turn on the Datamedia simulator in TELNET.  The only way to
send the EDIT key is by using the "↑" command to TELNET--this is because
their line scanners only know about 7-bit characters (sigh).